<?xml version="1.0" encoding="iso-8859-1" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content=
    "application/xhtml+xml; charset=iso-8859-1" />
    <title>
      Fluxbox-1.3.7
    </title>
    <link rel="stylesheet" type="text/css" href="../stylesheets/lfs.css" />
    <meta name="generator" content="DocBook XSL Stylesheets V1.78.1" />
    <link rel="stylesheet" href="../stylesheets/lfs-print.css" type=
    "text/css" media="print" />
  </head>
  <body class="blfs" id="blfs-2020-04-02">
    <div class="navheader">
      <h4>
        Beyond Linux<sup>�</sup> From Scratch <span class="phrase">(System
        V</span> Edition) - Version 2020-04-02
      </h4>
      <h3>
        Chapter&nbsp;27.&nbsp;Window Managers
      </h3>
      <ul>
        <li class="prev">
          <a accesskey="p" href="wm.html" title="Window Managers">Prev</a>
          <p>
            Window Managers
          </p>
        </li>
        <li class="next">
          <a accesskey="n" href="icewm.html" title="IceWM-1.6.5">Next</a>
          <p>
            IceWM-1.6.5
          </p>
        </li>
        <li class="up">
          <a accesskey="u" href="wm.html" title=
          "Chapter&nbsp;27.&nbsp;Window Managers">Up</a>
        </li>
        <li class="home">
          <a accesskey="h" href="../index.html" title=
          "Beyond Linux� From Scratch     (System V Edition) - Version 2020-04-02">
          Home</a>
        </li>
      </ul>
    </div>
    <div class="sect1" lang="en" xml:lang="en">
      <h1 class="sect1">
        <a id="fluxbox" name="fluxbox"></a>Fluxbox-1.3.7
      </h1>
      <div class="package" lang="en" xml:lang="en">
        <h2 class="sect2">
          Introduction to Fluxbox
        </h2>
        <p>
          The <span class="application">Fluxbox</span> package contains a
          window manager.
        </p>
        <p>
          This package is known to build and work properly using an LFS-9.1
          platform.
        </p>
        <h3>
          Package Information
        </h3>
        <div class="itemizedlist">
          <ul class="compact">
            <li class="listitem">
              <p>
                Download (HTTP): <a class="ulink" href=
                "https://downloads.sourceforge.net/fluxbox/fluxbox-1.3.7.tar.xz">
                https://downloads.sourceforge.net/fluxbox/fluxbox-1.3.7.tar.xz</a>
              </p>
            </li>
            <li class="listitem">
              <p>
                Download MD5 sum: b44afd10ee1e64624c23115aa51dcd55
              </p>
            </li>
            <li class="listitem">
              <p>
                Download size: 772 KB
              </p>
            </li>
            <li class="listitem">
              <p>
                Estimated disk space required: 101 MB
              </p>
            </li>
            <li class="listitem">
              <p>
                Estimated build time: 0.9 SBU
              </p>
            </li>
          </ul>
        </div>
        <h3>
          Fluxbox Dependencies
        </h3>
        <h4>
          Required
        </h4>
        <p class="required">
          <a class="xref" href="installing.html" title=
          "Chapter&nbsp;24.&nbsp;X Window System Environment">X Window
          System</a>
        </p>
        <h4>
          Optional
        </h4>
        <p class="optional">
          <a class="xref" href="../general/dbus.html" title=
          "dbus-1.12.16">dbus-1.12.16</a> (runtime), <a class="xref" href=
          "../general/fribidi.html" title="FriBidi-1.0.9">FriBidi-1.0.9</a>,
          and <a class="xref" href="imlib2.html" title=
          "imlib2-1.6.1">imlib2-1.6.1</a> (if you wish to use other image
          formats in addition to XPM)
        </p>
        <p class="usernotes">
          User Notes: <a class="ulink" href=
          "http://wiki.linuxfromscratch.org/blfs/wiki/fluxbox">http://wiki.linuxfromscratch.org/blfs/wiki/fluxbox</a>
        </p>
      </div>
      <div class="installation" lang="en" xml:lang="en">
        <h2 class="sect2">
          Installation of Fluxbox
        </h2>
        <p>
          Install <span class="application">Fluxbox</span> by running the
          following commands:
        </p>
        <pre class="userinput">
<kbd class="command">./configure --prefix=/usr &amp;&amp;
make</kbd>
</pre>
        <p>
          This package does not have a working testsuite.
        </p>
        <p>
          Now, as the <code class="systemitem">root</code> user:
        </p>
        <pre class="root">
<kbd class="command">make install</kbd>
</pre>
      </div>
      <div class="configuration" lang="en" xml:lang="en">
        <h2 class="sect2">
          Configuring Fluxbox
        </h2>
        <div class="sect3" lang="en" xml:lang="en">
          <h3 class="sect3">
            <a id="fluxbox-config" name="fluxbox-config"></a>
          </h3>
          <h4 class="title">
            <a id="fluxbox-config" name="fluxbox-config"></a>Config Files
          </h4>
          <p>
            <code class="filename">~/.fluxbox/init</code>, <code class=
            "filename">~/.fluxbox/keys</code>, and <code class=
            "filename">~/.fluxbox/menu</code>
          </p>
        </div>
        <div class="sect3" lang="en" xml:lang="en">
          <h3 class="sect3"></h3>
          <h4 class="title">
            <a id="idm140006429537712" name=
            "idm140006429537712"></a>Configuration Information
          </h4>
          <p>
            If <span class="application">Fluxbox</span> is the only Window
            Manager you want to use, you can start it with an <code class=
            "filename">.xinitrc</code> file in your home folder. Be sure to
            backup your current <code class="filename">.xinitrc</code> before
            proceeding.
          </p>
          <pre class="userinput">
<kbd class="command">echo startfluxbox &gt; ~/.xinitrc</kbd>
</pre>
          <p>
            Or alternatively, if you use a login manager like <a class="xref"
            href="../gnome/gdm.html" title="GDM-3.34.1">GDM-3.34.1</a> or
            <a class="xref" href="lightdm.html" title=
            "lightdm-1.30.0">lightdm-1.30.0</a>, and would like to be able to
            choose <span class="application">Fluxbox</span> at the login
            prompt, create a <code class="filename">fluxbox.desktop</code>
            file. As <code class="systemitem">root</code>:
          </p>
          <pre class="root">
<kbd class="command">mkdir -pv /usr/share/xsessions &amp;&amp;
cat &gt; /usr/share/xsessions/fluxbox.desktop &lt;&lt; "EOF"
<code class="literal">[Desktop Entry]
Encoding=UTF-8
Name=Fluxbox
Comment=This session logs you into Fluxbox
Exec=startfluxbox
Type=Application</code>
EOF</kbd>
</pre>
          <p>
            If you didn't install <a class="xref" href="../gnome/gdm.html"
            title="GDM-3.34.1">GDM-3.34.1</a> or <a class="xref" href=
            "lightdm.html" title="lightdm-1.30.0">lightdm-1.30.0</a> in
            <code class="filename">/usr</code>, then change that command to
            fit the prefix you chose.
          </p>
          <p>
            Now create the <span class="application">Fluxbox</span>
            configuration files:
          </p>
          <pre class="userinput">
<kbd class="command">mkdir -v ~/.fluxbox &amp;&amp;
cp -v /usr/share/fluxbox/init ~/.fluxbox/init &amp;&amp;
cp -v /usr/share/fluxbox/keys ~/.fluxbox/keys</kbd>
</pre>
          <p>
            To generate the application menu, first you may wish to run
            <span class="command"><strong>fluxbox-generate_menu
            -h</strong></span>, in order to choose any <em class=
            "replaceable"><code>&lt;user_options&gt;</code></em>, then issue:
          </p>
          <pre class="userinput">
<kbd class="command">cd ~/.fluxbox &amp;&amp;
fluxbox-generate_menu <em class=
"replaceable"><code>&lt;user_options&gt;</code></em></kbd>
</pre>
          <p>
            Alternately, copy a pregenerated menu:
          </p>
          <pre class="userinput">
<kbd class="command">cp -v /usr/share/fluxbox/menu ~/.fluxbox/menu</kbd>
</pre>
          <p>
            Menu items are added by editing <code class=
            "filename">~/.fluxbox/menu</code>. The syntax is explained on the
            <span class="command"><strong>fluxbox</strong></span> man page.
          </p>
          <p>
            If you want to use an image as your desktop background, copy the
            theme you like into <code class="filename">~/.fluxbox</code>.
            Then add a line to make it use the correct image. In the
            following command, change <em class=
            "replaceable"><code>&lt;theme&gt;</code></em> for the name of the
            theme you want and change <em class=
            "replaceable"><code>&lt;/path/to/nice/image.ext&gt;</code></em>
            to point to the actual image you want to use, where <em class=
            "replaceable"><code>ext</code></em> must be <span class=
            "quote">&ldquo;<span class="quote">xpm</span>&rdquo;</span>, if
            <a class="xref" href="imlib2.html" title=
            "imlib2-1.6.1">imlib2-1.6.1</a> is not installed to allow other
            image formats.
          </p>
          <pre class="userinput">
<kbd class=
"command">cp /usr/share/fluxbox/styles/&lt;theme&gt; ~/.fluxbox/theme &amp;&amp;

sed -i 's,\(session.styleFile:\).*,\1 ~/.fluxbox/theme,' ~/.fluxbox/init &amp;&amp;

[ -f ~/.fluxbox/theme ] &amp;&amp;
echo "background.pixmap: &lt;/path/to/nice/image.ext&gt;" &gt;&gt; ~/.fluxbox/theme ||
[ -d ~/.fluxbox/theme ] &amp;&amp;
echo "background.pixmap: &lt;/path/to/nice/image.ext&gt;" &gt;&gt; ~/.fluxbox/theme/theme.cfg</kbd>
</pre>
          <p>
            In some locales the font specified in the theme may not contain
            the needed characters. This results in menus with blank items.
            You can fix this by editing <code class=
            "filename">~/.fluxbox/theme</code> with a text editor and
            altering it so that it names a suitable font.
          </p>
        </div>
      </div>
      <div class="content" lang="en" xml:lang="en">
        <h2 class="sect2">
          Contents
        </h2>
        <div class="segmentedlist">
          <div class="seglistitem">
            <div class="seg">
              <strong class="segtitle">Installed Programs:</strong>
              <span class="segbody">fluxbox, fbsetbg, fbsetroot,
              fluxbox-generate_menu, startfluxbox, fbrun, fluxbox-remote, and
              fluxbox-update_configs</span>
            </div>
            <div class="seg">
              <strong class="segtitle">Installed Libraries:</strong>
              <span class="segbody">None</span>
            </div>
            <div class="seg">
              <strong class="segtitle">Installed Directories:</strong>
              <span class="segbody">/usr/share/fluxbox and ~/.fluxbox</span>
            </div>
          </div>
        </div>
        <div class="variablelist">
          <h3>
            Short Descriptions
          </h3>
          <table border="0" class="variablelist">
            <colgroup>
              <col align="left" valign="top" />
              <col />
            </colgroup>
            <tbody>
              <tr>
                <td>
                  <p>
                    <a id="fluxbox-prog" name="fluxbox-prog"></a><span class=
                    "term"><span class=
                    "command"><strong>fluxbox</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is a window manager for <span class=
                    "application">X11</span> based on <span class=
                    "application">Blackbox</span> 0.61.0.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="fbsetbg" name="fbsetbg"></a><span class=
                    "term"><span class=
                    "command"><strong>fbsetbg</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is a utility that sets the background image. It requires
                    one of the following at runtime: <span class=
                    "command"><strong>Esetroot</strong></span>, <span class=
                    "command"><strong>wmsetbg</strong></span>, <a class=
                    "xref" href="../xsoft/feh.html#feh-prog"><span class=
                    "command"><strong>feh</strong></span></a>, <span class=
                    "command"><strong>hsetroot</strong></span>, <span class=
                    "command"><strong>chbg</strong></span>, <a class="xref"
                    href="../general/imagemagick.html#display"><span class=
                    "command"><strong>display</strong></span></a>,
                    <span class="command"><strong>qiv</strong></span>,
                    <span class="command"><strong>xv</strong></span>,
                    <span class="command"><strong>xsri</strong></span>,
                    <span class="command"><strong>xli</strong></span>, or
                    <span class="command"><strong>xsetbg</strong></span>. It
                    also requires <a class="xref" href=
                    "../general/which.html#which-prog"><span class=
                    "command"><strong>which</strong></span></a> if
                    <span class="command"><strong>Esetroot</strong></span> is
                    found.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="fbsetroot" name="fbsetroot"></a><span class=
                    "term"><span class=
                    "command"><strong>fbsetroot</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is a utility to change root window appearance based on
                    the <span class="application">Blackbox</span> application
                    bsetroot.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="fluxbox-generate_menu" name=
                    "fluxbox-generate_menu"></a><span class=
                    "term"><span class=
                    "command"><strong>fluxbox-generate_menu</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is a utility that generates a menu by scanning your
                    <code class="envar">PATH</code>.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="startfluxbox" name="startfluxbox"></a><span class=
                    "term"><span class=
                    "command"><strong>startfluxbox</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is a session startup script that allows for command
                    executions prior to <span class=
                    "command"><strong>fluxbox</strong></span> starting.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="fbrun" name="fbrun"></a><span class=
                    "term"><span class=
                    "command"><strong>fbrun</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    displays a run dialog window.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="fluxbox-remote" name=
                    "fluxbox-remote"></a><span class="term"><span class=
                    "command"><strong>fluxbox-remote</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    provides command line access to key commands for
                    <span class="application">Fluxbox</span>.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="fluxbox-update_configs" name=
                    "fluxbox-update_configs"></a><span class=
                    "term"><span class=
                    "command"><strong>fluxbox-update_configs</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    use to manage config files (reload, update, test).
                  </p>
                </td>
              </tr>
            </tbody>
          </table>
        </div>
      </div>
      <p class="updated">
        Last updated on 2020-03-22 03:34:34 -0500
      </p>
    </div>
    <div class="navfooter">
      <ul>
        <li class="prev">
          <a accesskey="p" href="wm.html" title="Window Managers">Prev</a>
          <p>
            Window Managers
          </p>
        </li>
        <li class="next">
          <a accesskey="n" href="icewm.html" title="IceWM-1.6.5">Next</a>
          <p>
            IceWM-1.6.5
          </p>
        </li>
        <li class="up">
          <a accesskey="u" href="wm.html" title=
          "Chapter&nbsp;27.&nbsp;Window Managers">Up</a>
        </li>
        <li class="home">
          <a accesskey="h" href="../index.html" title=
          "Beyond Linux� From Scratch     (System V Edition) - Version 2020-04-02">
          Home</a>
        </li>
      </ul>
    </div>
  </body>
</html>
